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REVISIONS 


Original Issue -- Mark VIII.O Release, 
+. Changes for MARK 9.0 Release 


Replaced SPO with ODT throughout. 

1 Added COMPARE to "'S/C is initiated" paragraph. 

-2 Added COMPARE STATEMENT syntax. 
Updated AND COMPARE paragraph. 

3. Added COMPARE SPECIFICATION section. 7 

4 Added fifth paragraph ("Note that. ...'). 
-5 Added VOLUME SPECIFICATION section. | 

6 Updated ATTRIBUTE LIST section. | 
7 Updated "files may be listed" paragraph. 

1 Ree Eee "library maintenance" paragraph. 
Added "messages can be directed" sentence. 7 | 
ay Added NOT COPIED - IN DIRECTORY BUT NOT ‘ON cae and NOT. 

- COPIED - FILE LOCKED. 
Added SYSTEM/COPY paragraph and messages. — 
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12 : a. ee in 
‘ Reworte SYNTAX AND SEMANTICS ERROR MESSAGES section. 
=] | ee a er. 
- Added €name) and dunit) to all error messages. 
1. Deleted ERRORFILE. 
Added DIRCOPY. 
10-1 megeeed ee is executed" paragraph. 
ehanges for MARK 10. @) Release — 


Major revision--Rewritten to conform to CSG Work Flow Language 


(Revision B). 


“OTHE INFORMATION CONTAINED IN THIS DOCUMENT. 1S CONFIDENTIAL AND PROPRIETARY. TO BURROUGHS. | 
CORPORATION AND IS NOT TO BE DISCLOSED TO ANYONE OUTSIDE OF BURROUGHS CORPORATION WITHOUT 
THE PRIOR WRITTEN RELEASE FROM THE PATENT PIL OM OF BESO eS: CORPORATION’’ _ . pales 


BURRGUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


SYSTEM/COPY cS] » » ?= * ” @e ® 
COPY STATEMENT 


COPY SPECIFICATION . 8 


OPTION LIST 
File SPECIFICATION «» « 
FROM SPECIFICATION 
TO SPECIFICATION 2 2 
VOLUNE SPECIFICATION 
ATTRIBUTE LIST « « « @ 
COMPARE STATEMENT 
DIR STATEMENT ° 2 ° 
LIBRARY MAINTENANCE MESSAGES 


SYNTAX AND SEMANTICS ERROR MESSAGES 


DUPLICATION CHECKING 


MISSING FILES ° 2 = © © © 2 


DISK INPUT 
TAPE INPUT «2. © 0 « «© « 
ERROR RECOVERY 


STATUS QUERIES * * @ ® Sd id | 


TEACH and HELP 
STATUS «2 © © © © &@ 2 » 


Quit 

PROGRAM SWITCHES . 2 2 « 
SWITCH 0 
SHLICH 2 ow @ & © -<. = 4 
SWITCH 3 


SWITCH 9 CTemporary) ° 
INTERNAL FILES 


COPY LIBRARY TAPES «2. « « « » 


OPERATING SUGGESTIONS 


Be ae | 


pan 
oOwww OO NNN OY UR WIG RO oe be et et pe et pe pe 


COMPANY CONFIDENTIAL 
Bi000 SYSTEM/COPY ~ 
2222 2905 CE) 


sb 6 @ 8 8 6 | 
ee ee eo i, os el oe 


in-1 


BURROUGHS CORPORATION . 3 COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1i000 SYSTEM/ COPY 
SANTA BARBARA PLANT P.S- 2222 2905 CE) 


SYSTEM/ZCOPY 


SYSTEM/COPY is a library maintenance program that copies = and 
compares disk and tape files. It produces corporate standard 
(COPY) tibrary tapes which are not compatible with LOAD~DUMP 
tape Ss 


SYSTEM/COPY is initiated by the MCP commands COPY» COMPARE» ADD» 
and DIR. 
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COPY Statement Diagram 


BURROUGHS CORPURATION COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP | Bi000 SYSTEM/COPY 
SANTA BARBARA PLANT PeSe 2222 2905 CE) 


COPY sPECIFICATION 
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#--> ADD =~>+ t--> & *==- SET = <option list> -+ 
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COPY Specification Diagram 


The user may specify either COPY or ADD. COPY directs the 
program to copy alt of the files specified in the copy statement. 
In the case of disk copies where a file by the same name atready 
exists» the oid file will be removed and the new file will be 
entered in the disk director ye ADD is allowed only for disk 
output filess files cannot be added to an existing tibdrary tape. 
When ADD is specified» each file will be copied onty if ae fite 
with that name is not already on disk. 


The copies are done in the same order as they are specified itn 
the COPY command» except that ail copies from Pape are done in 
the order that the files appear on the tape. 
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The option list is used to set run-time options. All options are 


off by defaults» untess they are explicitly set through the option 
list. The name of a boolean option may be used alone» as a 


shorthand way of saying <option> = TRUE. 


UPTION VALUE 


SUMMARY boolean 
COMPARE boolean 
MANDATORY boolean 
DATE date range 


aan On np Ea ae 


The SUMMARY option will produce a listing of the copy 
and the results of the program. 


message» 
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COMPARE 


If COMPARE is specified» each fite wilt be compared immediately 
after it is copied. Tape files that cross reel boundaries will 
not be compared. To compare files without copying them» or to 
compare files that cross a reel boundary» the COMPARE statement 
must be used by itself - the user should specify COMPARE instead 
of COPY AND SET CCOMPARE). : 


If an output tape is created» its directory file witt also be 
compared immediately after it 1s created. If the directory 
crosses a reel boundary» then it cannot be compared. In that 
case» the following message will be displayed. 


DIRECTORY FOR <volume name> C<unit name>) CROSSED 
REEL BOUNDARY AND CANNOT BE COMPARED 


If SYSTEM/COPY detects an error when comparing the directory on 
an output tape» then the tape will be purged and ali copies to 
that tape wilt be ignored. The following message will be 
disptayed. 


DIRECTORY COMPARISON ERROR ON <volume name> (unit name>) 
ALL REQUESTS USING <volume name> HAYE BEEN ABORTED 


MANDATORY 


The MANDATORY option controls the action to be taken when a disk 
input file cannot be found. By default» if SYSTEM/COPY 
encounters a missing file it wit generate an error message and 
continue with the next copy request. However» if MANDATORY 1s 
specified» SYSTEM/COPY witl require operator intervention to 
correct ail missing file conditions» except those encountered 
after SYSTEM/COPY has started to copy a file. If a file name is 
listed which contains an equal sign» SYSTEM/COPY wiil insist on 
there being at tleast one file matching that name. 


The MANDATORY option has no effect on the handling of missing 


tape files. Regardiess of the setting of this option» 
SYSTEM/CGPY will atways hang waiting for each input tape's 
directory file. Ail files not included in the tape directory 


will be reported as not found. 
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DATE 


If DATE is specified» onty files whose update dates fail within 
the specified range wilt be copied or compared. If a file's 
update date is zero (Clast update occurred prior to the 9.0 
release)» then the file's creation date will be used instead of 
update date. SYSTEM/COPY wiit check each file specified in the 
file list» and widl ignore alt fites that do not match the date 
selection criteria. Values for the DATE option are: 


<date> Only files updated on the specified date witl 
be selected. 


BEFORE <date> Onty files updated before the specified date 
wiil be setected,. 


AFTER <date> Only files undated after the specified date w 
be selected. 


<datel> TO <date2> Files whose update dates fall within the specified 
range will be selected. The range is inciusive 


of the starting and stopping dates. 


Dates must be of the form MM/DD/YY. 
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FILE SPECIFICATION 
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File Specification Diagram 
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Tape File Name Diagram 
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Disk File Name Diagram 


Each file specification phrase contains an input file name and an 
optional output file name. If an output file name is not 
specified» the input file name is used for both input and output. 


! | Disk file names consist of a 10-character muitifiletid and a 
| 1O“character file-id.e Tape file names consist of 13 l/f=character 
| ids. An equal sign used as the last id means any character 
string can be used in that position. File names with more than 
two ids of 10 characters each are not allowed as disk names and 
so in copying these files to disk» the AS phrase is needede For 
examples to copy the file A/B/C/D from tape to disk» you would 

have to specify COPY A/B/C/D AS A/B FROM TAPE1CKIND=TAPE). 
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When GNTO jis used» as in COPY <fileil> ONTO <file2>» the first 
file is copied on top of the second file. The second file must 
be an instatiation atiocated disk CIAD) file. The two files must 
have the same number of areas» blocks per areas records per 
block» and record sizee After the copy is executed» the second 
fide's file type» creation date» and EOF pointer correspond to 
that of the first file. 


Aliso in the file specifications an attribute List may further 
define either of the file names» and is described later in this 
document. 


Note that if SYSTEM/COPY is executed with a usercodes =/= 15 
taken to mean (<usercode>)/=» and *=/= is not allowed. 


FROM SPECIFICATION 


The FROM phrase is used to teil the program which volume to use 
for input. It applies to alt file specifications preceding it. 
For example» COPY A»eBsC FROM TAPE1> D FROM TAPE2> tetts 
SYSTEM/COPY that files A» Bs» and C are on TAPEL and file D is on 
TAPE2. 


One FROM phrase is altowed per file List. You cannot use the 
Statement COPY A FROW TAPEL FROM TAPE2» but rather COPY A FROM 
TAPEL1» A FROM TAPE2. 


If the FROM phrase 1s missing» the program assumes the file is on 
System disk. However» you cannot use CUPY A» 8B FROM TAPE] to 
indicate that file A is on the system disk. Instead you must 
specify COPY A FROM DISK» B FROM TAPE1. Both DISK and * * can be 
used to specify the system pack. 


A maximum of 32 FROM phrases are ailowed per copy statement. 
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TQ SPECIFICATION 


The 10 phrase is used to tell the program which volumes to use 
for output. It follows the tast FROM specifications» if there 15 
ones and applies to alt the fite specifications. For exampler 
COPY A FROM TAPE1 Be Cs» 0 TO TAPES» TO TAPES» teils the program 
to copy file A from TAPE1 to TAPES and TAPES and copy files Be C» 
and 0 from the system disk Cif the FROM phrase is missing» the 
system disk is assumed) to TAPE3» and TAPE4. A maximum of eight 
TO phrases are altowed per copy statement. 


~YOLUME SPECIFICATION 
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Volume Specification Diagram 


The volume specification can be either DISK» or a volume name. 
DISK indicates the system disk. A volume name may be followed by 
an attribute tist which is. further described tater in this 
document. 


ATTRIBUTE List 
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Attribute List Diagram 


Each file and volume name within the copy statement may be 
optionaliy  foltowed by a List of attributes enclosed in 
parentheses» Onty those attributes marked with an asterisk (#) 
have been implemented in the 810090 version of SYSTEM/COPY. The 
unmarked attributes have not been implemented» and a warning 
message will be generated if they are used. | | 
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FILE ATTRIBUTES 


ATTRIBUTE VALUE USE DEVICE 


«FAMILYINDEX integer (0715) Output Disk only 
CYCLE integer Input/Output 

VERSION integer Input/Output 

*«SAVEF ACTOR integer Cutput Disk onty 
SINGLEUNTIT boolean | Output 


FAMILYINDEX 


The FAMILYINDEX attribute specifies which electronic unit of a 
disk family is to be used for an output file. 


SAVEFACTOR 


The SAVEFACTOR attribute specifies the value of the savefactor 
fietd in the output file'*s disk file header. 7 


VOLUME ATIRIBUTES 
ATTRIBUTE VALUE USE DEVICE 


* KIND Literal Input/Output 

*HOSTNAME | 17 character string Input/Output Disk only 
«VOLUME INDEX integer(179999) Input Tape only 
«DENSITY literal Input/Output Tape only 
SERTIALNO character string Input/Output 

*SAVEFACTOR integer Output Tape only 


KIND 


The KINO attribute specifies the hardware device to be used. 
Values are: 


DISK any disk 

TAPE any magnetic tape 

TAPEZ © | any 7“track magnetic tape 

TAPED any 9=track NRZ magnetic tape 

TAPEPE any 9*track phase-encoded magnetic tape 
TAPEGCR © any group*coded-recognition magnetic tape 
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DENSITY 
if a volume has KIND=TAPE» then the DENSITY attribute can be used 
to specify the recording density. 
Values are: 
BPI800 


BP11600 
BP16250 


VOLUMELNDEX 


The VOLUMEINDEX attribute specifies which reel of an input tape. 
should be used for the copye Searching widl beyin on that reel's 
directory. Previous reats will be ignored. 


SAVEFACTOR 


The SAVEFACTOR attribute is used to caiculate the expiration date 
for an output tape volume. Alt files on the volume will have the 
Same expiration date. 


HOSTNAME 


The HOSTNAME attribute specifies the system on which a volume 1s 
to be found. If HOSTNAME is specified» then the copy is done 
using the BNA Logical 1/0 mechanism and certain restrictions are 
enforced: 


1) "COMPARE™*» "ADD™» and "COPY ONTO" are not valids 

2) Tape files» whether input or output» are not valids and 

3) An "=" in a file name may be specified onty for source files 
which reside on the tocal host. 
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COMPARE STATEMENT 


COMPARE-- file nake tj... weasateoccnaanloctcne aah ona ee eae ues eee 


#- AS file name -> FROM vol spec => T0 vot spec 


COMPARE Statement Diagram 


With the COMPARE statement the user may compare files without 


having them copied. The syntax for the COMPARE statement is 
Similar to the COPY statement» except there can be only one input 
unit and one output unite A tisting 1s produced of the files 


that were compared» and any files that are in error are flagged. 
Examples: 


COMPARE = FROM MYTAPE CKIND=TAPE) TO MYDISK CKIND=DISK) 


CUMPARE FILE1 AS FILE2»+ XYZ/= FROM TAPEICKIND=TAPE) TO TAPE2CKIND=TAPE) 


The compare Listing contains the names of both the source (FROM) 
and copy (10) volumes» their reel number Cif appticable)» serial 
number Cif applicable)» and hardware kind. The name of each 
source file wilt be listed along with the name of the associated 
copy fiie» if different from the source file name. 


The files wiit be compared pair by pair. First the headers of 
the two files will be compared. If certain size retated fields 
in the header match» then the data portions of the files will be 
compared. If the files ara the same» then the file typer record 
size» records per blocks» endof-file pointer and creation date 
wili be printed. Utherwises» an explanation of the comparison 
error wiil be printed. 
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~* 


The following comparison errors are possible» <which> 15 either 
SOURCE FILE or COPY FILE. 


HEADER COMPARISON ERROR 
DATA COMPARISON NOT DONE 


HEADER COMPARISON ERROR IGNORED 
CDATA SUCCESSFULLY COMPARED] 


<which> NOT FOUND 

<which> IN USE 

<which> INVALID HEADER 

<which> INVALID DIRECTORY ENTRY 

DATA COMPARISON ERROR 

<which> I0 ERROR 

<which> UNRELIABLE TAPE DATA 

cwhich> REQUIRES TAPE REWIND 

COMPARISON TERMINATED BY "QUIT" 

<which> UNEXPECTED END-OF-FILE 

CANNOT COMPARE (MULTI-PACK} FILES 
{VARIABLE } 
(RELATIVE } 


<which> IN DIRECTORY 3UT NOT ON TAPE 
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DIR STATEMENT 


werr-> DIR TAPE "“<tape name>*® cerrrrnn= > 


The DIR command is used to tist the contents of a library tape. 
An example of the use of the syntax is DIR TAPE “MYTAPE". Onty 
one tape may be specified per DIR request and that tape name must 
be enclosed in quotes. 


' Qn occasions files may be Listed in the directory that do not 
actuaitty reside on tape. This situation usuatly occurs when the 
program creating the tape 18s adnormally terminated. It may also 
occur when ae file is removed before the original copy is 
complete. There is no way to detect deficient files by tlooking 
at the DIR listing. 


The DIR tlisting contains the tape volume names reel number Cif 
not reel 1)» hardware kinds and serial number. For each file oan 
the tapes» the following information is printed: 


ordinal number (position of the file on the tape) 
name 

type 

record size (Cin characters) 

records per block 

end~of-file pointer 

creation date 
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SYSTEM/COPY generates a tibrary maintenance message for each file 
it attempts to copy. If the MCP COPY option is set» atl these 
messages appear on the operator display terminal (ODT). {if the 
COPY option is reset» onty the error messages are displayed on 
the ODT. 


Fach message takes the form: 


<namel> <action> FROM <votume> (TO <volume>]) [ AS tname2> ] 
{[ ONTO ] 
(-<explanation>] 


In some error messages the TO phrase is omitted which means that 
all copies to that unit were aborted because of the explanation. 
given with the message» 


The fottowing tist enumerates possibile combinations of actions 
and explanations you might receive. These messages can be 
directed to the printer by using Program Switch 0» or the 
SUMMMARY option. 


COPIED 
The file was successfully copied. 


COPIED AND COMPARED 
The file was successfully copied and compared. 


COPIED BUT NOT COMPARED 
The file was successfully copied but could not be compared. 


NOT COPIED - NOT FOUND 
The file coutd not be found. 


NOT COPIED - SECURITY VIOLATION OR FILE REMOVED 

The file was found» but could not be opened» either because 
of a security violation» or because the file was removed by 
another user. | 


NOT COPIED - ONTO FILE NOT FOUND 
The output file used for an ONTO specification could not be 
found. 7 | 
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NOT COPIED - INCOMPATIBLE ONTO FILE 
The input and output files used in the ONTO specification 
were not compatible. 


NOT COPIED - MULTI-PACK FILE 
Multipack files cannot be copied. 


NOT COPIED = COPY OVER SELF NOT ALLOWED 
i. The copy was not done» because it would have destroyed the 
a input file. 


NOT COPIED ~ REQUIRES INPUT TAPE REWIND 
An input tape can be read onty once and if a copy requires a 
tape to be rewounds the copy cannot be completed. 


NOT COPIED - BAD FILE HEADER 
The input file had a bad header and could not be copied. 


NOT COPIED - FILE [IN USE 
The file was in use by another program and could not be 
opened readtonty by SYSTEM/COPY. 


COPIED - COMPARISON ERROR 
The file was copied but the comparison failed. 


COPIED - [0 ERRORS 
The file was copied but [0 errors occurred during the copy 
which the user chose to ignore. 


NOT COPIED - i0 ERRORS 
The copy was aborted because of [0 errors Ceither the errors 
were fatal or the user chose to abandon the copy). 


NOT COPIED - UNRELIABLE INPUT | 
The user chose to terminate the copy because the input file 
contained unreliable data. 
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The following errors can only occur when a HOSTNAME is specified 
in the copy request. 


NOT COPIED - NO USERCODE FILE IN NAME TABLE 
NOT COPIED - INVALID USERCODE/PASSWORD PAIR 


NOT COPIED - MISSING HOST - <host name> 
NOT COPIED ~ USERCODE NAMING CONVENTION VIOLATED 
NOT COPEED ~ REQUESTED FILE IS AN EXECUTE-ONLY CODE FILE ~ 


NOT COPIED ~- OUTPUT PACK NOT PRESENT 
NOT COPIED - ERROR IN GET/CHANGE ATTRIBUTE REQUEST 


The copy was aborted because a get or change attribute 
request failed. 


When SYSTEM/COPY has completed all the copies requested» it 
displays the foliowing messages. 

<n> FILES COPIED CAND COMPARED] 

<n> FILES COPIED BUT NOT COMPARED 

<n> FILES COPIED BUT HAD ERRORS 


<n> FILES NOT COPIED 


Each message is displayed only if <n> is not Zero. 
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SYNTAX AND SEMANTICS ERROR MESSAGES 


The entire copy statement 1S parsed before the actual copy is 
done. if any errors are discovered during parsings the program 
terminates with syntax errors and the copies are not done. 
Warnings are nonfatal and allow the copy to be continued. 
Program Switch 90 and the summary option can be used to direct 
these messages to either the OOT or the printer. 


The following error messages are results of errors that are 
always fatal» and cause the program to terminate with syntax 
errors. No copies will be done. 

“COMPARE” OR “SET™ EXPECTED FOLLOWING “&* OR “AND” 

"TAPE" EXPECTED FOLLOWING “DIR* 

MISSING KEYWORD - TRY “COPY"» “COMPARE™» “ADD"» OR *DIR* 

NUMERIC VALUE CONTAINS NON“NUMERIC CHARACTER - <value> 

VOLUME NAME HAS MORE THAN 10 CHARS - <volume name> 

VOLUME NAME CONTAINS SPECIAL CHARS - <volume name> 

TAPE VOLUME NAME CANNOT BE BLANK 

QUOTED STRING INCOMPLETE 

TOKEN TOO LONG - <token> 

MISSING FILE NAME 

TOO MANY SLASHES IN NANE - <file name> 

UNMATCHED EQUALS - <file namel> AND <file name2> 

When COPY <file namel> AS <file name2> is specified» the two 

mMames must have a compatible number of equais. COPY A/= AS 

B/C/= can be used but COPY A/= AS B/C cannot be used. 

UNKNOWN ATTRIBUTE - <attribute> 

NAME HAS TRAILING SLASH - <file name> 

VOLUME NAME EXPECTED FOLLOWING "TO" OR “FROM™ 


MISSING FINAL PARENTHESES 
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MISSING VALUE FOR <attribute or option> 
UNEXPECTED TEXT FOLLOWING LIST - <text> 
BLANK OR NULL [D IN NAME = <file name> 
BAD VALUE FOR <attribute> - <vatue> 
UNEXPECTED DELIMITER - <delimiter> 
INVALID USE OF ASTERISK = <file name> -_ : 


"ADO" AND “ONTO* BOTH SPECIFIED FOR <file name> 
"COMPARE™ AND “*ONTO" BOTH SPECIFIED FOR <fite name> 
OUTPUT TAPE <volume name> NOT ALLOWED WITH *ADD* 


"DIR TAPE™ MUST BE FOLLOWED BY QUOTED TAPE NAME 
DIR command was incorrectty entered. 


UNEXPECTED TEXT FOLLOWING DIR REQUEST 
"DIR" ONLY ALLOWED FOR TAPE 


DENSITY AND KIND DG NOT MATCH FOR VOLUME <volume name> 


"=" QNLY ALLOWED AS LAST ID OF NAME ~ <file name> 
OPTION LIST EXPECTED FOLLOWING “AND SET™ 

STARTING DATE GREATER THAN STOPPING DATE 

DATE EXPECTED 

INVALID DATE = <date> - MM/DD/YY EXPECTED 

NONEXISTENT DATE = <date> 

"TO" EXPECTED IN DATE RANGE SPECIFICATION 
UNKNOWN OPTION - <option> 


INVALID USE OF PAREN IN FILE NANE - <file name> 
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COMMA REQUIRED BETWEEN <what> 
Commas are required between OPTIONS» ATTRIBUTES» FILE LISTS 
and TO PHRASES. 
EQUAL REQUIRED AFTER - <attribute or option> 
TOO MANY “FROM"S - <volume name> IGNORED 
TOG MANY “TO"S = <volume name> IGNORED 
COPY STATEMENT MUST TERMINATE AFTER FIRST LIST OF *TO"S 
ONLY ONE “FROM™ AND ONE *TO0" ALLOWED WITH ” COMPARE" 
TOO MANY VOLUMES FOR ONE STATEMENT - <volume name> I[GNORED 
<type> ATTRIBUTE <attribute> USED OUT OF CONTEXT 
The attribute was used incorrectly. <type> may be FILE» 
INPUT FILE» OUTPUT FILE» VOLUME» INPUT VOLUME>» OUTPUT 
VOLUME» QUTPUT» TAPE VOLUME» or DISK FILE. 
"COMPARE™ NOT ALLOWED WITH "HOSTNAME" 
"ADD" NOT ALLOWED WITH “HOSTNANE" 
"COPY ONTO" NOT ALLOWED WITH “HOSTNAME” 
TAPE VOLUMES NOT ALLOWED WITH "HOSTNAME* 
e=" NOT ALLOWED FOR SOURCE FILES NOT ON LOCAL HOST 
The foltowing error messages are aresult of errors that are 
fatal if they are discovered during parsing. If they are 
discovered after the input text is parsed CUfor examples», while 


expanding names with equats (=)]» they cause only the file in 
error to be ignored» and the remaining files are copied. 


ACTIVE SYSTEM FILE CANNOT BE COPIED - <file name> 
The active system files SYSTEM/LOG>» SYSTEM/ELOG>» 
SYSTEM/ODILOG» and SYSTEM/O0DT.QUEVE» cannot be copied. 


DISK FILE NAME HAS MORE THAN 2 IDS - <file name> 

DISK FILE NAME HAS MORE THAN 10 CHARS IN ID - <file name> 
NON-STANDARD NAME FOR TAPE FILE - <file name> | 
Tape file names can have a maximum of 13 different 
identifiers of up to 17 characters Catphanumeric characters 
onty) eache | | i" 


CANNOT EXPAND <file namei> FROM <file name2> TO <file name3> 
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The following error messages are a result of errors that indicate 
a probtem with a tape unite All copies using that unit are 
ignored. | 


<volume name> NOT A TAPE 
<volume name> NOT A LIBRARY TAPE 
<voluse name> NOT CREATED BY 81000 COPY 


<volume name> INCORRECT TAPE LEVEL 


The following warnings are intended for user information onty. 
They are nonfatal and attow the copy to be continued. 


EMPTY ATTRIBUTE LIST IGNORED 
<attribute> ATTRIBUTE NOT IMPLEMENTED 


The program recognized the attribute» but it is not yet 
implemented. 


"ONTO" COPY OF <file name> TO <volume name> CHANGED TO *AS* 
Onto copies are not allowed with output tapes. 


DUPLICATE COPY OF <file name> NOT DONE 
OUTPUT BUFFERING CHANGED TO 1 SINCE COMPARE NOT SPECIFIED 
FAMILYINDEX IGNORED WITH HOSTNAME 
The following warning and error messages are intended to ease the 
transition from the 9.0 to the 10.0 syntax. 
DEFAULT “TO DISK™ NO LONGER ASSUMED FOLLOWING “FROM™ 


| "KIND" MUST BE SPECIFIED FOR <volume name> 
Unless Switch 9 is set to 1» no default kind is assumed. 
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DUPLICATION CHECKING 


The 10.0 and tater versions of SYSTEM/COPY do not do as much 
checking for duplicate copies as older versions. The oaonty 
default checking provided is to prevent copying a file over. 


The user may not wish duplicate files on a tape. Setting program 
SWitch 3=1 jwill guarantee that each output tape contains files 
with unique namese 


If duplicate disk copies are requested each copy will remove’ the 
files copied before it. If this is not desired» ADD may be 
specified. In that case» only the first copy request for each 
file will be done. 
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DISK INPUT 


When SYSTEM/COPY discovers that an input disk is off-line» it 
Will disptay the following mesage: 


PACK <volume name> IS NOT ON@LINE 
PLEASE MOUNT THE PACK AND AX *READY" 
OR AX *SKIP™ TO SKIP ALL REQUESTS USING THIS PACK 


If the operator resonds with READY» then SYSTEM/COPY will verify 
that the disk is ontline» and continue the copy. If the operator 
responds with SKIP» then SYSTEM/COPY will abort ali copies using 
the missing disk» and display the following message: 


ALL REQUESTS USING <volume name> HAVE BEEN ABORTED 


If the disk 1s onwtine and the file cannot be found» then the 
setting of the MANDATORY option determines the program's actions. 
If MANDATORY is TRUE» then SYSTEM/COPY wilt display the following 
messages 


FILE <file name> [S NOT PRESENT 
AX "OK WHEN THE FILE I5 AVAILABLE 
GR AX "OF" TUG IGNORE THE FILE 


The operator may respond with OK» indicating that the file is now 
available» or OF» indicating that the file should be ignored. 
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TAPE INPUT 


If a tape unit 15 off-line» the program witt hang waiting for the 
file <tape name>/TAPDIR1I977. In this case the operator should 
either ready the tape or IL the file to another tape. 


A missing file condition may atso occur after the program has 
begun copying from the tape. This situation occurs when the 
program that created the tape is O05eed after the directory is 
built and before ali the files are copied. SYSTEM/COPY witt 
display the fotlowing message» and all subsequent copies using 
that tape will be aborted. 


LIBRARY TAPE <volume name> IS INCOMPLETE 
ALL REQUESTS USING <volume name> HAVE BEEN ABORTED 
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ERROR RECOVERY 


SYSTEM/COPY attempts to recover from errors on tlibrary files 
whenever possible. Three types of errors are possible: 1/70 
errors» comparison errorss and unretiable input errors. 


When an I/0 error is detected» the program will display the 
following message. 


EXCEPTION ON <volume name> C<unit name>) 


WHILE f€ READING } 
{ WRITING } 


{ DIRECTORY BANNER RECORD 

€ DIRECTORY FORMATTING RECORD 
{ DIRECTORY HEADERS 

{ DIRECTORY 

{ HEADERS FOR <file name> 

{ <file name> 


toy yt yt yd ye 


When a comparison error is detected» the program will display the 
following message. 


COMPARISON ERROR ON <volume name> (C<unit name>) 


FOR FILE <file name> 


When an unretiable input record is detected» the program witti 
display the following message. 


{[ BLOCK NUMBER <integer> ON J] TAPE <votume name> (<unit name>) 
CONTAINS UNRELIABLE DATA FOR SEGMENTS <integer> - <integer> 
OF FILE <file name> 


Depending on the nature of the errors the user will be asked to 
choose from several courses of action: 


AX "CONTINUE" TO IGNORE THE ERROR 
AX "QUIT" TO ABANDON ONLY THIS FILE 
AX "ABORT" TG ABORT ALL REQUESTS USING THIS UNIT 
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If the error is critical» such as one during the writing of a 
tape's header records» the program does not offer CONTINUE as a 
choice. If the error occurs on an output tape directory » the 
tape will be purged and no copies using that tane witl be done. 


If you tell the program to continues it attempts to gloss over 
the error and continue the copy or compare. If you elect to tell 
the program to quit» it gives up on the file in error. If the 
file in error is an input’ files all the output files are 
abandoned. If the file in error is an output file» onty the file 
in error 1s abandoned. If you choose to tettl the program to 
aborts ail copies using the bad unit are abandoned. 


COPY library tapes mark each record as reliabte or unreliable. 
If you choose to continue after an input 1/0 error» the 
corresponding output tape record is marked as unreliable. If you 
elect to quit the copy» the final tape record is marked as 
unreliable. All unreliable input records encountered during a 
copy are reported to the user. | 
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STATUS QUERIES 


Unsolicited ODT input is atlowed any time SYSTEM/COPY is copying 
or comparing a file. Commands are entered using the MCP accept 
message: 


<job number> AX <command> 


Valid commands are TEACH» HELP» STATUS and QUIT. 


TEACH and HELP 


The TEACH and HELP commands cause SYSTEM/COPY to display a tist 
of valid OO7T commands: 


SYSTEM/CUPY ACCEPTS THE FOLLOWING COMMANDS 
TEACH/HELP = DISPLAY THESE INSTRUCTIONS 

STATUS = DISPLAY CURRENT PROGRAM STATUS 

QUIT = DISCONTINUE PROCESSING THE CURRENT FILE 


If STATUS is requested» then SYSTEM/COPY wilt display a message 
describing the status of the file currently being processed. 


{COPYING +} <file name> FROM <volume name> 
{COMPARING } 
{TRANSFERRING} 


( <# complete> / <total #> {RECORDS } 2) 
{SEGMENTS} 


QUIT 


If QUIT is entered on the ODT» then SYSTEM/COPY will discontinue 
processing the current file» and will go on to the next file 
awaiting processing. 


rie 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


SWITCH 9 


Directs messages to the 


0=03 Messages go 
Q0=1: Messages go 
Q0=2: Messages go 
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QOT or printer. 


to the ODT 
to the 'orinter. 


to both the ODOT and the printer. 


Controls which names area allowed for tape fites. 


2=038 Special characters aitowed. 
2-13 Oniy alphanumeric characters allowed as per corporate 


standard. 


3=0: No checking 


for duplicate copies witli be done. 


3=1: No duplicate files wilt be copied to the output 


tape Se 


g=03 No KIND default. 


9=1: DISK is the 


default vatue for KIND. Will suppress 


warning messages for discrepancies between the old 
(9.1 and earttier) and new (10.0 and later) syntax. 
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SOURCE 


LINE 


CLAUSEFILE 
NAMEFILE 
HDRFILE 
NAME QUEUE 
DIRCOPY 


DUPFILE 


SORTFILE 


INF ILE 
OUTFILE1! 
QUTFILE2 


QUIFILES 


INTERNAL FILES 


Contains the actual copy request. This file is 
built by the MCP» and is removed by SYSTEM/COPY 
after the copy request is parsed. This file is called 
COPY/<unique number> or (<usercode>)/<unique number>. 


Printer file 


Work files 


Fites used for actuai copying. 
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COPY LIBRARY TAPES 


SYSTEM/COPY produces corporate standard libary tapes which are 
intended to be compatible with other Burroughs systems. 
Currently» SYSTEM/COPY onty handles tapes created by 381000 
systems. 


The first file on each reel Cor the second file if the first file 
is a continuation of a previous reet)» is a directory of alt 
files on that reel and ail subsequent reels. Only the directory 
on the first reel is comprehensive, atl other directories are 
subsets of the first directory. Each directory fite is labelled 
"TAPDIR1I977" and contains a tist of the files on the tape and 
their file headers. 


Each data file on the tape is tabelled "F<8-digit number>” 
Starting with "F09000001" for the first data file on the first 
reel. Each data file contains a file identifier record» foilowed 
by a symbolic file header» an object file neader» and finally the 
data areas. | 
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OPERATING SUGGESTIONS 


SYSTEM/COPY usually runs with a dynamic memory size of 5000 bits» 
which is sufficient for handling up to 16 volumes. If more than 
16 volumes are specified» then the user may need to increase the 
dynamic memory S$iz@e 


The input file INFILE uses two buffers» White alt the output 
files use only one buffer each. Performance may be improved by 
increasing the number of buffers. However» if the output files 
use more than one buffer» then the COMPARE option must be 
specified. This is because if more than one buffer is specified 
for an output file» it is possible that an I[/0 error at the end 
of the file might not be detected. Specifying COMPARE ensures 
that such an error will be reported. If memory is limited» the 
files may be modified to request only one buffer each. 


All work fites are declared with 25 areas and 100 btocks per 
are@ae This allows approximatety 15000 files to be copied with a 
Single copy request. If more files are to be copied» then the 
work fites should be modified to have larger areas. 


If SYSTEM/COPY is executed from the ODOT or a card reader without 
a usercodes» it 18 a privileged programe attowing 31t to copy ail 


public and private files. If SYSTEM/COPY is fired up fron 
anywhere other than the ODT or card reader (eege» through a ZIP 
command)» 1t ais considered nonprivileged and is onty able to 


access public files. I[f SYSTEM/COPY is executed with a usercodes» 
it has the same privileges as the usercode with which it is run. 
If the usercode is privileged» SYSTEM/COPY is able to access all 
public and private files. If the usercode is nonprivilegeds» only 
public files or files with the same usercode can be accessed by 
SYSTEM/COPY» and all the output files must have the usercode as 
the multifilecrid. 7 
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